[Table of Contents] [docx version]
Error! No text of specified style in document.
Run level formatting is the most granular property level and allows for the specifying of all low level text properties. The text run is what all paragraphs are derived from and thus specifying various properties per run will allow for a diversely formatted text paragraph.
[Example: Consider the case where have multiple runs within a paragraph and you wish to apply bold to only one of them without having to split up the text into higher level XML groups. To do this we would simply apply the bold run property to the text run that we wish to format as shown below.
<a:r>
…
</a:r>
<a:r>
<a:rPr lang="en-US" b="1" dirty="0" smtClean="0"/>
<a:t>This text will be bold</a:t>
</a:r>
<a:r>
…
</a:r>
end example]
This element specifies that a complex script font be used for a specific run of text. This font will be specified with a typeface attribute much like the others but will specifically be classified as a complex script font.
[Example: Consider the DrawingML shown below.
<a:r>
<a:rPr …>
<a:cs typeface="Sample Font"/>
</a:rPr>
<a:t>Sample Text</a:t>
</a:r>
The above run of text will be rendered using the complex script font "Sample Font". end example]
Parent Elements |
defRPr (§5.1.5.3.2); endParaRPr (§5.1.5.2.3); font (§5.1.4.2.13); majorFont (§5.1.4.1.24); minorFont (§5.1.4.1.25); rPr (§5.1.5.3.9) |
Attributes |
Description |
charset (Similar Character Set) |
Specifies the most similar character set to the one being used. This is useful if the generating application cannot use the current font and must choose a similar one.
The possible values for this attribute are defined by the XML Schema byte datatype. |
panose (Panose Setting) |
Specifies the panose standard setting that will be used to determine the closest matching font by any generating application that employs this method.
The possible values for this attribute are defined by the ST_Panose simple type (§5.1.12.37). |
pitchFamily (Similar Font Family) |
Specifies the most similar font family to the one being used. This is useful if the generating application cannot use the current font and must choose a similar one.
The possible values for this attribute are defined by the XML Schema byte datatype. |
typeface (Text Typeface) |
Specifies the typeface, or name of the font that is to be used for a bullet. The typeface used here should be selected from the font list of the generating application.
The possible values for this attribute are defined by the ST_TextTypeface simple type (§5.1.12.81). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_TextFont">
<attribute name="typeface" type="ST_TextTypeface"/>
<attribute name="panose" type="ST_Panose" use="optional"/>
<attribute name="pitchFamily" type="xsd:byte" use="optional" default="0"/>
<attribute name="charset" type="xsd:byte" use="optional" default="1"/>
</complexType>
defRPr (Default Text Run Properties)
This element contains all default run level text properties for the text runs within a containing paragraph. These properties are to be used when overriding properties have not been defined within the rPr element.
[Example: Consider the DrawingML shown below.
<a:p>
…
<a:rPr u="sng"/>
…
<a:t>Some Text</a:t>
…
</a:p>
The run of text described above will be formatting with a single underline of text matching color. end example]
Parent Elements |
defPPr (§5.1.5.2.2); lvl1pPr (§5.1.5.4.13); lvl2pPr (§5.1.5.4.14); lvl3pPr (§5.1.5.4.15); lvl4pPr (§5.1.5.4.16); lvl5pPr (§5.1.5.4.17); lvl6pPr (§5.1.5.4.18); lvl7pPr (§5.1.5.4.19); lvl8pPr (§5.1.5.4.20); lvl9pPr (§5.1.5.4.21); pPr (§5.1.5.2.7) |
Child Elements |
Subclause |
blipFill (Picture Fill) |
§5.1.10.14 |
cs (Complex Script Font) |
§5.1.5.3.1 |
ea (East Asian Font) |
§5.1.5.3.3 |
effectDag (Effect Container) |
§5.1.10.25 |
effectLst (Effect Container) |
§5.1.10.26 |
extLst (Extension List) |
§5.1.2.1.15 |
gradFill (Gradient Fill) |
§5.1.10.33 |
grpFill (Group Fill) |
§5.1.10.35 |
highlight (Highlight Color) |
§5.1.5.3.4 |
hlinkClick (Click Hyperlink) |
§5.1.5.3.5 |
hlinkMouseOver (Mouse-Over Hyperlink) |
§5.1.5.3.6 |
latin (Latin Font) |
§5.1.5.3.7 |
ln (Outline) |
§5.1.2.1.24 |
noFill (No Fill) |
§5.1.10.44 |
pattFill (Pattern Fill) |
§5.1.10.47 |
solidFill (Solid Fill) |
§5.1.10.54 |
sym (Symbol Font) |
§5.1.5.3.10 |
uFill (Underline Fill) |
§5.1.5.3.12 |
uFillTx (Underline Fill Properties Follow Text) |
§5.1.5.3.13 |
uLn (Underline Stroke) |
§5.1.5.3.14 |
uLnTx (Underline Follows Text) |
§5.1.5.3.15 |
Attributes |
Description |
altLang (Alternative Language) |
Specifies the alternate language to use when the generating application is displaying the user interface controls. If this attribute is omitted, than the lang attribute will be used here.
The possible values for this attribute are defined by the ST_TextLanguageID simple type (§5.1.12.72). |
b (Bold) |
Specifies whether a run of text will be formatted as bold text. If this attribute is omitted, than a value of 0, or false is assumed. [Example: Consider the DrawingML shown below. <a:p> The above run of text will be formatted as bold text. end example]
The possible values for this attribute are defined by the XML Schema boolean datatype. |
baseline (Baseline) |
Specifies the baseline for both the superscript and subscript fonts. The size is specified using a percentage where 1000 is equal to 1 percent of the font size and 100000 is equal to 100 percent font of the font size.
The possible values for this attribute are defined by the ST_Percentage simple type (§5.1.12.41). |
bmk (Bookmark Link Target) |
Specifies the link target name that is used to reference to the proper link properties in a custom XML part within the document.
The possible values for this attribute are defined by the XML Schema string datatype. |
cap (Capitalization) |
Specifies the capitalization that is to be applied to the text run. This is a render-only modification and does not affect the actual characters stored in the text run. This attribute is also distinct from the toggle function where the actual characters stored in the text run are changed.
The possible values for this attribute are defined by the ST_TextCapsType simple type (§5.1.12.64). |
dirty (Dirty) |
Specifies that the content of a text run has changed since the proofing tools have last been run. Effectively this flags text that must be checked again by the generating application for mistakes such as spelling, grammar, etc.
The possible values for this attribute are defined by the XML Schema boolean datatype. |
err (Spelling Error) |
Specifies that when this run of text was checked for spelling, grammar, etc. that a mistake was indeed found. This allows the generating application to effectively save the state of the mistakes within the document instead of having to perform a full pass check upon opening the document.
The possible values for this attribute are defined by the XML Schema boolean datatype. |
i (Italics) |
Specifies whether a run of text will be formatted as italic text. If this attribute is omitted, than a value of 0, or false is assumed.
[Example: Consider the DrawingML shown below.
<a:p>
The above run of text will be formatted as italic text. end example]
The possible values for this attribute are defined by the XML Schema boolean datatype. |
kern (Kerning) |
Specifies the minimum font size at which character kerning will occur for this text run. Whole points are specified in increments of 100 starting with 100 being a point size of 1. For instance a font point size of 12 would be 1200 and a font point size of 12.5 would be 1250. If this attribute is omitted, than kerning will occur for all font sizes down to a 0 point font.
The possible values for this attribute are defined by the ST_TextNonNegativePoint simple type (§5.1.12.74). |
kumimoji (Kumimoji) |
Specifies whether the numbers contained within vertical text will continue vertically with the text or whether they are to be displayed horizontally while the surrounding characters continue in a vertical fashion. If this attribute is omitted, than a value of 0, or false is assumed.
The possible values for this attribute are defined by the XML Schema boolean datatype. |
lang (Language ID) |
Specifies the language to be used when the generating application is displaying the user interface controls. If this attribute is omitted, than the generating application may select a language of its choice.
The possible values for this attribute are defined by the ST_TextLanguageID simple type (§5.1.12.72). |
noProof (No Proofing) |
Specifies that a run of text has been selected by the user to not be checked for mistakes. Therefore if there are spelling, grammar, etc mistakes within this text the generating application should ignore them.
The possible values for this attribute are defined by the XML Schema boolean datatype. |
normalizeH (Normalize Heights) |
Specifies the normalization of height that is to be applied to the text run. This is a render-only modification and does not affect the actual characters stored in the text run. This attribute is also distinct from the toggle function where the actual characters stored in the text run are changed. If this attribute is omitted, than a value of 0, or false will be assumed.
The possible values for this attribute are defined by the XML Schema boolean datatype. |
smtClean (SmartTag Clean) |
Specifies whether or not a text run has been checked for smart tags. This attribute acts much like the dirty attribute dose for the checking of spelling, grammar, etc. A value of true here indicates to the generating application that this text run should be checked for smart tags. If this attribute is omitted, than a value of 0, or false is assumed.
The possible values for this attribute are defined by the XML Schema boolean datatype. |
smtId (SmartTag ID) |
Specifies the reference id for the smart tag. This id corresponds to a link within this slides relationship file. The following of this link within the relationship file will result in the actual smart tag information for this piece of text.
The possible values for this attribute are defined by the XML Schema unsignedInt datatype. |
spc (Spacing) |
Specifies the spacing between characters within a text run. This spacing is specified numerically and should be consistently applied across the entire run of text by the generating application. Whole points are specified in increments of 100 starting with 100 being a point size of 1. For instance a font point size of 12 would be 1200 and a font point size of 12.5 would be 1250. If this attribute is omitted than a value of 0 or no adjustment is assumed.
The possible values for this attribute are defined by the ST_TextPoint simple type (§5.1.12.75). |
strike (Strikethrough) |
Specifies whether a run of text will be formatted as strikethrough text. If this attribute is omitted, than no strikethrough is assumed.
[Example: Consider the DrawingML shown below.
<a:p>
The above run of text will be formatted as single strikethrough text. end example]
The possible values for this attribute are defined by the ST_TextStrikeType simple type (§5.1.12.79). |
sz (Font Size) |
Specifies the size of text within a text run. Whole points are specified in increments of 100 starting with 100 being a point size of 1. For instance a font point size of 12 would be 1200 and a font point size of 12.5 would be 1250. If this attribute is omitted, than the value in defRPr should be used.
[Example: Consider the DrawingML shown below.
<a:p>
The above run of text will be formatted with a 12 point text size. end example]
The possible values for this attribute are defined by the ST_TextFontSize simple type (§5.1.12.68). |
u (Underline) |
Specifies whether a run of text will be formatted as underlined text. If this attribute is omitted, than no underline is assumed.
[Example: Consider the DrawingML shown below.
<a:p>
The above run of text will be formatted as single underline text. end example]
The possible values for this attribute are defined by the ST_TextUnderlineType simple type (§5.1.12.82). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_TextCharacterProperties">
<sequence>
<element name="ln" type="CT_LineProperties" minOccurs="0" maxOccurs="1"/>
<group ref="EG_FillProperties" minOccurs="0" maxOccurs="1"/>
<group ref="EG_EffectProperties" minOccurs="0" maxOccurs="1"/>
<element name="highlight" type="CT_Color" minOccurs="0" maxOccurs="1"/>
<group ref="EG_TextUnderlineLine" minOccurs="0" maxOccurs="1"/>
<group ref="EG_TextUnderlineFill" minOccurs="0" maxOccurs="1"/>
<element name="latin" type="CT_TextFont" minOccurs="0" maxOccurs="1"/>
<element name="ea" type="CT_TextFont" minOccurs="0" maxOccurs="1"/>
<element name="cs" type="CT_TextFont" minOccurs="0" maxOccurs="1"/>
<element name="sym" type="CT_TextFont" minOccurs="0" maxOccurs="1"/>
<element name="hlinkClick" type="CT_Hyperlink" minOccurs="0" maxOccurs="1"/>
<element name="hlinkMouseOver" type="CT_Hyperlink" minOccurs="0" maxOccurs="1"/>
<element name="extLst" type="CT_OfficeArtExtensionList" minOccurs="0" maxOccurs="1"/>
</sequence>
<attribute name="kumimoji" type="xsd:boolean" use="optional"/>
<attribute name="lang" type="ST_TextLanguageID" use="optional"/>
<attribute name="altLang" type="ST_TextLanguageID" use="optional"/>
<attribute name="sz" type="ST_TextFontSize" use="optional"/>
<attribute name="b" type="xsd:boolean" use="optional"/>
<attribute name="i" type="xsd:boolean" use="optional"/>
<attribute name="u" type="ST_TextUnderlineType" use="optional"/>
<attribute name="strike" type="ST_TextStrikeType" use="optional"/>
<attribute name="kern" type="ST_TextNonNegativePoint" use="optional"/>
<attribute name="cap" type="ST_TextCapsType" use="optional"/>
<attribute name="spc" type="ST_TextPoint" use="optional"/>
<attribute name="normalizeH" type="xsd:boolean" use="optional"/>
<attribute name="baseline" type="ST_Percentage" use="optional"/>
<attribute name="noProof" type="xsd:boolean" use="optional"/>
<attribute name="dirty" type="xsd:boolean" use="optional" default="true"/>
<attribute name="err" type="xsd:boolean" use="optional" default="false"/>
<attribute name="smtClean" type="xsd:boolean" use="optional" default="true"/>
<attribute name="smtId" type="xsd:unsignedInt" use="optional" default="0"/>
<attribute name="bmk" type="xsd:string" use="optional"/>
</complexType>
This element specifies that an East Asian font be used for a specific run of text. This font will be specified with a typeface attribute much like the others but will specifically be classified as an East Asian font.
[Example: Consider the DrawingML shown below.
<a:r>
<a:rPr …>
<a:ea typeface="Sample Font"/>
</a:rPr>
<a:t>Sample Text</a:t>
</a:r>
The above run of text will be rendered using the East Asian font "Sample Font". end example]
Parent Elements |
defRPr (§5.1.5.3.2); endParaRPr (§5.1.5.2.3); font (§5.1.4.2.13); majorFont (§5.1.4.1.24); minorFont (§5.1.4.1.25); rPr (§5.1.5.3.9) |
Attributes |
Description |
charset (Similar Character Set) |
Specifies the most similar character set to the one being used. This is useful if the generating application cannot use the current font and must choose a similar one.
The possible values for this attribute are defined by the XML Schema byte datatype. |
panose (Panose Setting) |
Specifies the panose standard setting that will be used to determine the closest matching font by any generating application that employs this method.
The possible values for this attribute are defined by the ST_Panose simple type (§5.1.12.37). |
pitchFamily (Similar Font Family) |
Specifies the most similar font family to the one being used. This is useful if the generating application cannot use the current font and must choose a similar one.
The possible values for this attribute are defined by the XML Schema byte datatype. |
typeface (Text Typeface) |
Specifies the typeface, or name of the font that is to be used for a bullet. The typeface used here should be selected from the font list of the generating application.
The possible values for this attribute are defined by the ST_TextTypeface simple type (§5.1.12.81). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_TextFont">
<attribute name="typeface" type="ST_TextTypeface"/>
<attribute name="panose" type="ST_Panose" use="optional"/>
<attribute name="pitchFamily" type="xsd:byte" use="optional" default="0"/>
<attribute name="charset" type="xsd:byte" use="optional" default="1"/>
</complexType>
This element specifies the highlight color that will be present for a run of text.
[Example: Consider the DrawingML shown below.
<p:txBody>
…
<a:p>
<a:r>
<a:rPr …>
<a:highlight>
<a:srgbClr val="FFFF00"/>
</a:highlight>
</a:rPr>
…
<a:t>Sample Text</a:t>
…
</a:r>
</a:p>
…
</p:txBody>
The above run of text will have a yellow highlight color as specified by the srgbClr child element. end example]
Parent Elements |
defRPr (§5.1.5.3.2); endParaRPr (§5.1.5.2.3); rPr (§5.1.5.3.9) |
Child Elements |
Subclause |
hslClr (Hue, Saturation, Luminance Color Model) |
§5.1.2.2.13 |
prstClr (Preset Color) |
§5.1.2.2.22 |
schemeClr (Scheme Color) |
§5.1.2.2.29 |
scrgbClr (RGB Color Model - Percentage Variant) |
§5.1.2.2.30 |
srgbClr (RGB Color Model - Hex Variant) |
§5.1.2.2.32 |
sysClr (System Color) |
§5.1.2.2.33 |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Color">
<sequence>
<group ref="EG_ColorChoice"/>
</sequence>
</complexType>
Specifies the on-click hyperlink information to be applied to a run of text. When the hyperlink text is clicked the link will be fetched.
[Example: Consider the DrawingML shown below.
<p:txBody>
…
<a:p>
<a:r>
<a:rPr …>
<a:hlinkClick r:id="rId2" tooltip="Some Sample Text"/>
</a:rPr>
…
<a:t>Sample Text</a:t>
…
</a:r>
</a:p>
…
</p:txBody>
The above run of text will be a hyperlink that points to the resource pointed at by rId2 within this slides relationship file. Additionally this text should display a tooltip when the mouse is hovered over the run of text. end example]
Parent Elements |
cNvPr (§5.2.2.3); cNvPr (§5.8.2.7); cNvPr (§4.4.1.12); cNvPr (§5.6.2.8); cNvPr (§5.1.2.1.8); defRPr (§5.1.5.3.2); docPr (§5.5.2.5); endParaRPr (§5.1.5.2.3); rPr (§5.1.5.3.9) |
Child Elements |
Subclause |
extLst (Extension List) |
§5.1.2.1.15 |
snd (Hyperlink Sound) |
§5.1.2.1.32 |
Attributes |
Description |
action (Action Setting) |
Specifies an action that is to be taken when this hyperlink is activated. This may be used to specify a slide to be navigated to or a script of code to be run.
The possible values for this attribute are defined by the XML Schema string datatype. |
endSnd (End Sounds) |
Specifies if the URL in question should stop all sounds that are playing when it is clicked.
The possible values for this attribute are defined by the XML Schema boolean datatype. |
highlightClick (Highlight Click) |
Specifies if this attribute has already been used within this document. That is when a hyperlink has already been visited that this attribute would be utilized so the generating application may determine the color of this text. If this attribute is omitted, then a value of 0 or false is implied.
The possible values for this attribute are defined by the XML Schema boolean datatype. |
history (Add Hyperlink to Page History) |
Specifies whether to add this URI to the history when navigating to it. This allows for the viewing of this presentation without the storing of history information on the viewing machine. If this attribute is omitted, then a value of 1, or true is assumed.
The possible values for this attribute are defined by the XML Schema boolean datatype. |
id (Drawing Object Hyperlink Target)
Namespace: .../officeDocument/2006/relationships |
Specifies the relationship id that when looked up in this slides relationship file will contain the target of this hyperlink. This attribute cannot be omitted.
The possible values for this attribute are defined by the ST_RelationshipId simple type (§7.8.2.1). |
invalidUrl (Invalid URL) |
Specifies the URL when it has been determined by the generating application that the URL is invalid. That is the generating application may still store the URL but it is known that this URL is not correct.
The possible values for this attribute are defined by the XML Schema string datatype. |
tgtFrame (Target Frame) |
Specifies the target frame that is to be used when opening this hyperlink. When the hyperlink is activated this attribute will be used to determine if a new window must be launched for viewing or if an existing one may be used. If this attribute is omitted, than a new window will be opened.
The possible values for this attribute are defined by the XML Schema string datatype. |
tooltip (Hyperlink Tooltip) |
Specifies the tooltip that should be displayed when the hyperlink text is hovered over with the mouse. If this attribute is omitted, than the hyperlink text itself may be displayed.
The possible values for this attribute are defined by the XML Schema string datatype. |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Hyperlink">
<sequence>
<element name="snd" type="CT_EmbeddedWAVAudioFile" minOccurs="0" maxOccurs="1"/>
<element name="extLst" type="CT_OfficeArtExtensionList" minOccurs="0" maxOccurs="1"/>
</sequence>
<attribute ref="r:id" use="optional"/>
<attribute name="invalidUrl" type="xsd:string" use="optional" default=""/>
<attribute name="action" type="xsd:string" use="optional" default=""/>
<attribute name="tgtFrame" type="xsd:string" use="optional" default=""/>
<attribute name="tooltip" type="xsd:string" use="optional" default=""/>
<attribute name="history" type="xsd:boolean" use="optional" default="true"/>
<attribute name="highlightClick" type="xsd:boolean" use="optional" default="false"/>
<attribute name="endSnd" type="xsd:boolean" use="optional" default="false"/>
</complexType>
hlinkMouseOver (Mouse-Over Hyperlink)
Specifies the mouse-over hyperlink information to be applied to a run of text. When the mouse is hovered over this hyperlink text the link will be fetched.
[Example: Consider the DrawingML shown below.
<p:txBody>
…
<a:p>
<a:r>
<a:rPr …>
<a:hlinkMouseOver r:id="rId2" tooltip="Some Sample Text"/>
</a:rPr>
…
<a:t>Sample Text</a:t>
…
</a:r>
</a:p>
…
</p:txBody>
The above run of text will be a hyperlink that points to the resource pointed at by rId2 within this slides relationship file. Additionally this text should display a tooltip when the mouse is hovered over the run of text. end example]
Parent Elements |
defRPr (§5.1.5.3.2); endParaRPr (§5.1.5.2.3); rPr (§5.1.5.3.9) |
Child Elements |
Subclause |
extLst (Extension List) |
§5.1.2.1.15 |
snd (Hyperlink Sound) |
§5.1.2.1.32 |
Attributes |
Description |
action (Action Setting) |
Specifies an action that is to be taken when this hyperlink is activated. This may be used to specify a slide to be navigated to or a script of code to be run.
The possible values for this attribute are defined by the XML Schema string datatype. |
endSnd (End Sounds) |
Specifies if the URL in question should stop all sounds that are playing when it is clicked.
The possible values for this attribute are defined by the XML Schema boolean datatype. |
highlightClick (Highlight Click) |
Specifies if this attribute has already been used within this document. That is when a hyperlink has already been visited that this attribute would be utilized so the generating application may determine the color of this text. If this attribute is omitted, then a value of 0 or false is implied.
The possible values for this attribute are defined by the XML Schema boolean datatype. |
history (Add Hyperlink to Page History) |
Specifies whether to add this URI to the history when navigating to it. This allows for the viewing of this presentation without the storing of history information on the viewing machine. If this attribute is omitted, then a value of 1, or true is assumed.
The possible values for this attribute are defined by the XML Schema boolean datatype. |
id (Drawing Object Hyperlink Target)
Namespace: .../officeDocument/2006/relationships |
Specifies the relationship id that when looked up in this slides relationship file will contain the target of this hyperlink. This attribute cannot be omitted.
The possible values for this attribute are defined by the ST_RelationshipId simple type (§7.8.2.1). |
invalidUrl (Invalid URL) |
Specifies the URL when it has been determined by the generating application that the URL is invalid. That is the generating application may still store the URL but it is known that this URL is not correct.
The possible values for this attribute are defined by the XML Schema string datatype. |
tgtFrame (Target Frame) |
Specifies the target frame that is to be used when opening this hyperlink. When the hyperlink is activated this attribute will be used to determine if a new window must be launched for viewing or if an existing one may be used. If this attribute is omitted, than a new window will be opened.
The possible values for this attribute are defined by the XML Schema string datatype. |
tooltip (Hyperlink Tooltip) |
Specifies the tooltip that should be displayed when the hyperlink text is hovered over with the mouse. If this attribute is omitted, than the hyperlink text itself may be displayed.
The possible values for this attribute are defined by the XML Schema string datatype. |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Hyperlink">
<sequence>
<element name="snd" type="CT_EmbeddedWAVAudioFile" minOccurs="0" maxOccurs="1"/>
<element name="extLst" type="CT_OfficeArtExtensionList" minOccurs="0" maxOccurs="1"/>
</sequence>
<attribute ref="r:id" use="optional"/>
<attribute name="invalidUrl" type="xsd:string" use="optional" default=""/>
<attribute name="action" type="xsd:string" use="optional" default=""/>
<attribute name="tgtFrame" type="xsd:string" use="optional" default=""/>
<attribute name="tooltip" type="xsd:string" use="optional" default=""/>
<attribute name="history" type="xsd:boolean" use="optional" default="true"/>
<attribute name="highlightClick" type="xsd:boolean" use="optional" default="false"/>
<attribute name="endSnd" type="xsd:boolean" use="optional" default="false"/>
</complexType>
This element specifies that a Latin font be used for a specific run of text. This font will be specified with a typeface attribute much like the others but will specifically be classified as a Latin font.
[Example: Consider the DrawingML shown below.
<a:r>
<a:rPr …>
<a:latin typeface="Sample Font"/>
</a:rPr>
<a:t>Sample Text</a:t>
</a:r>
The above run of text will be rendered using the Latin font "Sample Font". end example]
Parent Elements |
defRPr (§5.1.5.3.2); endParaRPr (§5.1.5.2.3); font (§5.1.4.2.13); majorFont (§5.1.4.1.24); minorFont (§5.1.4.1.25); rPr (§5.1.5.3.9) |
Attributes |
Description |
charset (Similar Character Set) |
Specifies the most similar character set to the one being used. This is useful if the generating application cannot use the current font and must choose a similar one.
The possible values for this attribute are defined by the XML Schema byte datatype. |
panose (Panose Setting) |
Specifies the panose standard setting that will be used to determine the closest matching font by any generating application that employs this method.
The possible values for this attribute are defined by the ST_Panose simple type (§5.1.12.37). |
pitchFamily (Similar Font Family) |
Specifies the most similar font family to the one being used. This is useful if the generating application cannot use the current font and must choose a similar one.
The possible values for this attribute are defined by the XML Schema byte datatype. |
typeface (Text Typeface) |
Specifies the typeface, or name of the font that is to be used for a bullet. The typeface used here should be selected from the font list of the generating application.
The possible values for this attribute are defined by the ST_TextTypeface simple type (§5.1.12.81). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_TextFont">
<attribute name="typeface" type="ST_TextTypeface"/>
<attribute name="panose" type="ST_Panose" use="optional"/>
<attribute name="pitchFamily" type="xsd:byte" use="optional" default="0"/>
<attribute name="charset" type="xsd:byte" use="optional" default="1"/>
</complexType>
This element specifies the presence of a run of text within the containing text body. The run element is the lowest level text separation mechanism within a text body. A text run may contain text run properties associated with the run. If no properties are listed then properties specified in the defRPr element are used.
[Example: Consider the case where the user would like to describe a text body that will contain two runs of text and would like one to be bold and the other not. The following DrawingML would specify such a text body.
<p:txBody>
…
<a:r>
<a:rPr b="1">
</a:rPr>
<a:t>Some text</a:t>
</a:r>
…
<a:r>
<a:rPr/>
<a:t>Some text</a:t>
</a:r>
</p:txBody>
The above text body will have the first run be formatted bold and the second normally. end example]
Parent Elements |
p (§5.1.5.2.6) |
Child Elements |
Subclause |
rPr (Text Run Properties) |
§5.1.5.3.9 |
t (Text String) |
§5.1.5.3.11 |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_RegularTextRun">
<sequence>
<element name="rPr" type="CT_TextCharacterProperties" minOccurs="0" maxOccurs="1"/>
<element name="t" type="xsd:string" minOccurs="1" maxOccurs="1"/>
</sequence>
</complexType>
This element contains all run level text properties for the text runs within a containing paragraph.
[Example: Consider the DrawingML shown below.
<a:p>
…
<a:rPr u="sng"/>
…
<a:t>Some Text</a:t>
…
</a:p>
The run of text described above will be formatting with a single underline of text matching color. end example]
Parent Elements |
br (§5.1.5.2.1); fld (§5.1.5.2.4); r (§5.1.5.3.8) |
Child Elements |
Subclause |
blipFill (Picture Fill) |
§5.1.10.14 |
cs (Complex Script Font) |
§5.1.5.3.1 |
ea (East Asian Font) |
§5.1.5.3.3 |
effectDag (Effect Container) |
§5.1.10.25 |
effectLst (Effect Container) |
§5.1.10.26 |
extLst (Extension List) |
§5.1.2.1.15 |
gradFill (Gradient Fill) |
§5.1.10.33 |
grpFill (Group Fill) |
§5.1.10.35 |
highlight (Highlight Color) |
§5.1.5.3.4 |
hlinkClick (Click Hyperlink) |
§5.1.5.3.5 |
hlinkMouseOver (Mouse-Over Hyperlink) |
§5.1.5.3.6 |
latin (Latin Font) |
§5.1.5.3.7 |
ln (Outline) |
§5.1.2.1.24 |
noFill (No Fill) |
§5.1.10.44 |
pattFill (Pattern Fill) |
§5.1.10.47 |
solidFill (Solid Fill) |
§5.1.10.54 |
sym (Symbol Font) |
§5.1.5.3.10 |
uFill (Underline Fill) |
§5.1.5.3.12 |
uFillTx (Underline Fill Properties Follow Text) |
§5.1.5.3.13 |
uLn (Underline Stroke) |
§5.1.5.3.14 |
uLnTx (Underline Follows Text) |
§5.1.5.3.15 |
Attributes |
Description |
altLang (Alternative Language) |
Specifies the alternate language to use when the generating application is displaying the user interface controls. If this attribute is omitted, than the lang attribute will be used here.
The possible values for this attribute are defined by the ST_TextLanguageID simple type (§5.1.12.72). |
b (Bold) |
Specifies whether a run of text will be formatted as bold text. If this attribute is omitted, than a value of 0, or false is assumed. [Example: Consider the DrawingML shown below. <a:p> The above run of text will be formatted as bold text. end example]
The possible values for this attribute are defined by the XML Schema boolean datatype. |
baseline (Baseline) |
Specifies the baseline for both the superscript and subscript fonts. The size is specified using a percentage where 1000 is equal to 1 percent of the font size and 100000 is equal to 100 percent font of the font size.
The possible values for this attribute are defined by the ST_Percentage simple type (§5.1.12.41). |
bmk (Bookmark Link Target) |
Specifies the link target name that is used to reference to the proper link properties in a custom XML part within the document.
The possible values for this attribute are defined by the XML Schema string datatype. |
cap (Capitalization) |
Specifies the capitalization that is to be applied to the text run. This is a render-only modification and does not affect the actual characters stored in the text run. This attribute is also distinct from the toggle function where the actual characters stored in the text run are changed.
The possible values for this attribute are defined by the ST_TextCapsType simple type (§5.1.12.64). |
dirty (Dirty) |
Specifies that the content of a text run has changed since the proofing tools have last been run. Effectively this flags text that must be checked again by the generating application for mistakes such as spelling, grammar, etc.
The possible values for this attribute are defined by the XML Schema boolean datatype. |
err (Spelling Error) |
Specifies that when this run of text was checked for spelling, grammar, etc. that a mistake was indeed found. This allows the generating application to effectively save the state of the mistakes within the document instead of having to perform a full pass check upon opening the document.
The possible values for this attribute are defined by the XML Schema boolean datatype. |
i (Italics) |
Specifies whether a run of text will be formatted as italic text. If this attribute is omitted, than a value of 0, or false is assumed.
[Example: Consider the DrawingML shown below.
<a:p>
The above run of text will be formatted as italic text. end example]
The possible values for this attribute are defined by the XML Schema boolean datatype. |
kern (Kerning) |
Specifies the minimum font size at which character kerning will occur for this text run. Whole points are specified in increments of 100 starting with 100 being a point size of 1. For instance a font point size of 12 would be 1200 and a font point size of 12.5 would be 1250. If this attribute is omitted, than kerning will occur for all font sizes down to a 0 point font.
The possible values for this attribute are defined by the ST_TextNonNegativePoint simple type (§5.1.12.74). |
kumimoji (Kumimoji) |
Specifies whether the numbers contained within vertical text will continue vertically with the text or whether they are to be displayed horizontally while the surrounding characters continue in a vertical fashion. If this attribute is omitted, than a value of 0, or false is assumed.
The possible values for this attribute are defined by the XML Schema boolean datatype. |
lang (Language ID) |
Specifies the language to be used when the generating application is displaying the user interface controls. If this attribute is omitted, than the generating application may select a language of its choice.
The possible values for this attribute are defined by the ST_TextLanguageID simple type (§5.1.12.72). |
noProof (No Proofing) |
Specifies that a run of text has been selected by the user to not be checked for mistakes. Therefore if there are spelling, grammar, etc mistakes within this text the generating application should ignore them.
The possible values for this attribute are defined by the XML Schema boolean datatype. |
normalizeH (Normalize Heights) |
Specifies the normalization of height that is to be applied to the text run. This is a render-only modification and does not affect the actual characters stored in the text run. This attribute is also distinct from the toggle function where the actual characters stored in the text run are changed. If this attribute is omitted, than a value of 0, or false will be assumed.
The possible values for this attribute are defined by the XML Schema boolean datatype. |
smtClean (SmartTag Clean) |
Specifies whether or not a text run has been checked for smart tags. This attribute acts much like the dirty attribute dose for the checking of spelling, grammar, etc. A value of true here indicates to the generating application that this text run should be checked for smart tags. If this attribute is omitted, than a value of 0, or false is assumed.
The possible values for this attribute are defined by the XML Schema boolean datatype. |
smtId (SmartTag ID) |
Specifies the reference id for the smart tag. This id corresponds to a link within this slides relationship file. The following of this link within the relationship file will result in the actual smart tag information for this piece of text.
The possible values for this attribute are defined by the XML Schema unsignedInt datatype. |
spc (Spacing) |
Specifies the spacing between characters within a text run. This spacing is specified numerically and should be consistently applied across the entire run of text by the generating application. Whole points are specified in increments of 100 starting with 100 being a point size of 1. For instance a font point size of 12 would be 1200 and a font point size of 12.5 would be 1250. If this attribute is omitted than a value of 0 or no adjustment is assumed.
The possible values for this attribute are defined by the ST_TextPoint simple type (§5.1.12.75). |
strike (Strikethrough) |
Specifies whether a run of text will be formatted as strikethrough text. If this attribute is omitted, than no strikethrough is assumed.
[Example: Consider the DrawingML shown below.
<a:p>
The above run of text will be formatted as single strikethrough text. end example]
The possible values for this attribute are defined by the ST_TextStrikeType simple type (§5.1.12.79). |
sz (Font Size) |
Specifies the size of text within a text run. Whole points are specified in increments of 100 starting with 100 being a point size of 1. For instance a font point size of 12 would be 1200 and a font point size of 12.5 would be 1250. If this attribute is omitted, than the value in defRPr should be used.
[Example: Consider the DrawingML shown below.
<a:p>
The above run of text will be formatted with a 12 point text size. end example]
The possible values for this attribute are defined by the ST_TextFontSize simple type (§5.1.12.68). |
u (Underline) |
Specifies whether a run of text will be formatted as underlined text. If this attribute is omitted, than no underline is assumed.
[Example: Consider the DrawingML shown below.
<a:p>
The above run of text will be formatted as single underline text. end example]
The possible values for this attribute are defined by the ST_TextUnderlineType simple type (§5.1.12.82). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_TextCharacterProperties">
<sequence>
<element name="ln" type="CT_LineProperties" minOccurs="0" maxOccurs="1"/>
<group ref="EG_FillProperties" minOccurs="0" maxOccurs="1"/>
<group ref="EG_EffectProperties" minOccurs="0" maxOccurs="1"/>
<element name="highlight" type="CT_Color" minOccurs="0" maxOccurs="1"/>
<group ref="EG_TextUnderlineLine" minOccurs="0" maxOccurs="1"/>
<group ref="EG_TextUnderlineFill" minOccurs="0" maxOccurs="1"/>
<element name="latin" type="CT_TextFont" minOccurs="0" maxOccurs="1"/>
<element name="ea" type="CT_TextFont" minOccurs="0" maxOccurs="1"/>
<element name="cs" type="CT_TextFont" minOccurs="0" maxOccurs="1"/>
<element name="sym" type="CT_TextFont" minOccurs="0" maxOccurs="1"/>
<element name="hlinkClick" type="CT_Hyperlink" minOccurs="0" maxOccurs="1"/>
<element name="hlinkMouseOver" type="CT_Hyperlink" minOccurs="0" maxOccurs="1"/>
<element name="extLst" type="CT_OfficeArtExtensionList" minOccurs="0" maxOccurs="1"/>
</sequence>
<attribute name="kumimoji" type="xsd:boolean" use="optional"/>
<attribute name="lang" type="ST_TextLanguageID" use="optional"/>
<attribute name="altLang" type="ST_TextLanguageID" use="optional"/>
<attribute name="sz" type="ST_TextFontSize" use="optional"/>
<attribute name="b" type="xsd:boolean" use="optional"/>
<attribute name="i" type="xsd:boolean" use="optional"/>
<attribute name="u" type="ST_TextUnderlineType" use="optional"/>
<attribute name="strike" type="ST_TextStrikeType" use="optional"/>
<attribute name="kern" type="ST_TextNonNegativePoint" use="optional"/>
<attribute name="cap" type="ST_TextCapsType" use="optional"/>
<attribute name="spc" type="ST_TextPoint" use="optional"/>
<attribute name="normalizeH" type="xsd:boolean" use="optional"/>
<attribute name="baseline" type="ST_Percentage" use="optional"/>
<attribute name="noProof" type="xsd:boolean" use="optional"/>
<attribute name="dirty" type="xsd:boolean" use="optional" default="true"/>
<attribute name="err" type="xsd:boolean" use="optional" default="false"/>
<attribute name="smtClean" type="xsd:boolean" use="optional" default="true"/>
<attribute name="smtId" type="xsd:unsignedInt" use="optional" default="0"/>
<attribute name="bmk" type="xsd:string" use="optional"/>
</complexType>
This element specifies that a symbol font be used for a specific run of text. This font will be specified with a typeface attribute much like the others but will specifically be classified as a symbol font.
[Example: Consider the DrawingML shown below.
<a:r>
<a:rPr …>
<a:sym typeface="Sample Font"/>
</a:rPr>
<a:t>Sample Text</a:t>
</a:r>
The above run of text will be rendered using the symbol font "Sample Font". end example]
Parent Elements |
defRPr (§5.1.5.3.2); endParaRPr (§5.1.5.2.3); rPr (§5.1.5.3.9) |
Attributes |
Description |
charset (Similar Character Set) |
Specifies the most similar character set to the one being used. This is useful if the generating application cannot use the current font and must choose a similar one.
The possible values for this attribute are defined by the XML Schema byte datatype. |
panose (Panose Setting) |
Specifies the panose standard setting that will be used to determine the closest matching font by any generating application that employs this method.
The possible values for this attribute are defined by the ST_Panose simple type (§5.1.12.37). |
pitchFamily (Similar Font Family) |
Specifies the most similar font family to the one being used. This is useful if the generating application cannot use the current font and must choose a similar one.
The possible values for this attribute are defined by the XML Schema byte datatype. |
typeface (Text Typeface) |
Specifies the typeface, or name of the font that is to be used for a bullet. The typeface used here should be selected from the font list of the generating application.
The possible values for this attribute are defined by the ST_TextTypeface simple type (§5.1.12.81). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_TextFont">
<attribute name="typeface" type="ST_TextTypeface"/>
<attribute name="panose" type="ST_Panose" use="optional"/>
<attribute name="pitchFamily" type="xsd:byte" use="optional" default="0"/>
<attribute name="charset" type="xsd:byte" use="optional" default="1"/>
</complexType>
t (Text String)
This element specifies the actual text for this text run. This is the text that will be formatted using all specified body, paragraph and run properties. This element must be present within a run of text.
[Example: Consider the DrawingML shown below.
<p:txBody>
…
<a:p>
…
<a:r>
…
<a:t>Sample Text</a:t>
…
</a:r>
…
</a:p>
…
</p:txBody>
The above DrawingML specifies a text body containing a single paragraph, containing a single run which contains the actual text specified with the <a:t> element.
The possible values for this element are defined by the XML Schema string datatype.
Parent Elements |
fld (§5.1.5.2.4); r (§5.1.5.3.8) |
This element specifies the fill color of an underline for a run of text.
[Example: Consider the DrawingML shown below.
<p:txBody>
…
<a:p>
<a:r>
<a:rPr …>
<a:uFill>
<a:solidFill>
<a:srgbClr val="FFFF00"/>
</a:solidFill>
</a:uFill>
</a:rPr>
…
<a:t>Sample Text</a:t>
…
</a:r>
</a:p>
…
</p:txBody>
The underline color of the above text will be yellow specified by the srgbClr child element. end example]
Parent Elements |
defRPr (§5.1.5.3.2); endParaRPr (§5.1.5.2.3); rPr (§5.1.5.3.9) |
Child Elements |
Subclause |
blipFill (Picture Fill) |
§5.1.10.14 |
gradFill (Gradient Fill) |
§5.1.10.33 |
grpFill (Group Fill) |
§5.1.10.35 |
noFill (No Fill) |
§5.1.10.44 |
pattFill (Pattern Fill) |
§5.1.10.47 |
solidFill (Solid Fill) |
§5.1.10.54 |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_TextUnderlineFillGroupWrapper">
<group ref="EG_FillProperties" minOccurs="1" maxOccurs="1"/>
</complexType>
uFillTx (Underline Fill Properties Follow Text)
This element specifies that the fill color of an underline for a run of text should be of the same color as the text run within which it is contained.
[Example: Consider the DrawingML shown below.
<p:txBody>
…
<a:p>
<a:r>
<a:rPr …>
<a:uFillTx>
</a:rPr>
…
<a:t>Sample Text</a:t>
…
</a:r>
</a:p>
…
</p:txBody>
The underline color of the above text will follow the color of the text run within which it resides. end example]
Parent Elements |
defRPr (§5.1.5.3.2); endParaRPr (§5.1.5.2.3); rPr (§5.1.5.3.9) |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_TextUnderlineFillFollowText"/>
This element specifies the properties for the stroke of the underline that will be present within a run of text.
[Example: Consider the DrawingML shown below.
<p:txBody>
…
<a:p>
<a:r>
<a:rPr …>
<a:uLn algn="r">
</a:rPr>
…
<a:t>Sample Text</a:t>
…
</a:r>
</a:p>
…
</p:txBody>
The underline alignment of the above text will be right aligned. end example]
Parent Elements |
defRPr (§5.1.5.3.2); endParaRPr (§5.1.5.2.3); rPr (§5.1.5.3.9) |
Child Elements |
Subclause |
bevel (Line Join Bevel) |
§5.1.10.9 |
custDash (Custom Dash) |
§5.1.10.21 |
extLst (Extension List) |
§5.1.2.1.15 |
gradFill (Gradient Fill) |
§5.1.10.33 |
headEnd (Line Head/End Style) |
§5.1.10.38 |
miter (Miter Line Join) |
§5.1.10.43 |
noFill (No Fill) |
§5.1.10.44 |
pattFill (Pattern Fill) |
§5.1.10.47 |
prstDash (Preset Dash) |
§5.1.10.48 |
round (Round Line Join) |
§5.1.10.52 |
solidFill (Solid Fill) |
§5.1.10.54 |
§5.1.10.57 |
Attributes |
Description |
algn (Stroke Alignment) |
Specifies the alignment to be used for the underline stroke.
The possible values for this attribute are defined by the ST_PenAlignment simple type (§5.1.12.40). |
cap (Line Ending Cap Type) |
Specifies the ending caps that should be used for this line. Examples of cap types are rounded, flat, etc. If this attribute is omitted, than a value of square is assumed.
The possible values for this attribute are defined by the ST_LineCap simple type (§5.1.12.31). |
cmpd (Compound Line Type) |
Specifies the compound line type to be used for the underline stroke. If this attribute is omitted, then a value of sng is assumed.
The possible values for this attribute are defined by the ST_CompoundLine simple type (§5.1.12.15). |
w (Line Width) |
Specifies the width to be used for the underline stroke. If this attribute is omitted, then a value of 0 is assumed.
The possible values for this attribute are defined by the ST_LineWidth simple type (§5.1.12.35). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_LineProperties">
<sequence>
<group ref="EG_LineFillProperties" minOccurs="0" maxOccurs="1"/>
<group ref="EG_LineDashProperties" minOccurs="0" maxOccurs="1"/>
<group ref="EG_LineJoinProperties" minOccurs="0" maxOccurs="1"/>
<element name="headEnd" type="CT_LineEndProperties" minOccurs="0" maxOccurs="1"/>
<element name="tailEnd" type="CT_LineEndProperties" minOccurs="0" maxOccurs="1"/>
<element name="extLst" type="CT_OfficeArtExtensionList" minOccurs="0" maxOccurs="1"/>
</sequence>
<attribute name="w" type="ST_LineWidth" use="optional"/>
<attribute name="cap" type="ST_LineCap" use="optional"/>
<attribute name="cmpd" type="ST_CompoundLine" use="optional"/>
<attribute name="algn" type="ST_PenAlignment" use="optional"/>
</complexType>
uLnTx (Underline Follows Text)
This element specifies that the stroke style of an underline for a run of text should be of the same as the text run within which it is contained.
[Example: Consider the DrawingML shown below.
<p:txBody>
…
<a:p>
<a:r>
<a:rPr …>
<a:uLnTx>
</a:rPr>
…
<a:t>Sample Text</a:t>
…
</a:r>
</a:p>
…
</p:txBody>
The underline stroke of the above text will follow the stroke of the run text within which it resides. end example]
Parent Elements |
defRPr (§5.1.5.3.2); endParaRPr (§5.1.5.2.3); rPr (§5.1.5.3.9) |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_TextUnderlineLineFollowText"/>